IABContainer : IMAPIContainer

The IABContainer interface provides access to address book containers. MAPI and client applications call the methods of the IABContainer interface to perform name resolution and to create, copy, and delete recipients.

Quick Info

Header file:

MAPIDEFS.H

Exposed by:

Address book container objects

Implemented by:

Address book providers

Called by:

MAPI and client applications

Corresponding pointer type:

LPABCONT

Transaction model:

Non-transacted

 

Vtable Order

CreateEntry_RNXW1

Creates a new entry, which can be a messaging user, a distribution list, or another container.

CopyEntriesGXHOK5

Copies one or more entries,  typically messaging users or distribution lists .

DeleteEntries5AW5GA

Removes one or more entries, typically messaging users, distribution lists, or other containers.

ResolveNamesIN_SU3

Performs name resolution for one or more recipient entries.

 

 

 

Required properties

Access

PR_CONTAINER_FLAGSX9D1VM

Read/write

PR_DISPLAY_NAME1KS30YA

Read/write

PR_ENTRYID2JH9H8T

Read-only

PR_OBJECT_TYPE4YLDI0

Read-only

PR_RECORD_KEYQV4J.N

Read-only

 

 

Optional properties

Access

PR_CONTAINER_CONTENTSKJXKKY

Read-only

PR_CONTAINER_HIERARCHY_S8XM0

Read-only

PR_DEF_CREATE_DLGQM3MH

Read-only

PR_DEF_CREATE_MAILUSER1S5ITDO

Read-only

PR_DISPLAY_TYPEYIXSE1

Read-only

 

Remarks

IABContainer inherits indirectly from IUnknown through IMAPIContainer and IMAPIProp. Address book providers implement IABContainer.

Any number of messaging user objects, distribution lists, and other address book containers can exist within an address book container. As with any container, clients or service providers can use an address book container to open one of its entries or to retrieve a hierarchy table or contents table. Address book containers also provide name resolution and, depending on the provider, the ability to add, remove, or modify entries.

MAPI defines a special address book container, called the Personal Address Book (PAB), that is meant to hold entries copied from other containers. A PAB is always modifiable. Users typically populate their PAB with entries designating the recipients with which they most frequently communicate. A PAB can also hold one-off addresses, new recipients not yet a part of any address book container.